home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1997 January: Mac OS SDK / Dev.CD Jan 97 SDK2.toast / Development Kits (Disc 2) / OpenDoc Development Framework / ODF-Interest Archive / August 96 / SUMMARY(long) ODF Build & CW9 & < prev    next >
Encoding:
Internet Message Format  |  1996-08-13  |  5.5 KB  |  [TEXT/ttxt]
  1. Subject:     SUMMARY(long):ODF Build & CW9 & 68K myOpenDocPart on 68K Mac 
  2. Sent:        8/12/96 10:51 AM
  3. Received:    8/12/96 11:01 AM
  4. From:        Peter vdr.Post, pepo@knoware.nl
  5. Reply-To:    ODF Interest, ODF-Interest@CILabs.ORG
  6. To:          OpenDoc Development Framework Discussion List, ODF-Interest@CILabs.
  7.  
  8. This SUMMARY describes my experiences to startup the development of 68K
  9. OpenDoc parts by means of the OpenDoc Development Framework (ODF) Release
  10. 1.0 on a 68K-type Macintosh with the CodeWarrior 9 Development environment
  11. (pffff, that was a long one).
  12.  
  13. It's primary intended for newbies on OpenDoc development to lower the edge
  14. to step-in! I thought it was difficult and that the development process
  15. requires a *lot* of resources. It turns out that's pretty easy. After
  16. reading this note, every 68K Mac developers should jump on the OpenDoc/ODF
  17. train :-)
  18.  
  19. Many thanks to the ODF team and members of the ODF-Interest list who
  20. prepared all the work to be done. I just add my experiences to it.
  21.  
  22. Have fun,
  23. Peter van der Post
  24.  
  25.  
  26.  
  27. Installation of ODF R1
  28. ----------------------
  29.  
  30. 1.installed ODF R1 from OpenDoc DR5 with 'ODF Installer'.
  31. 2.apply changes from CW9 Conversion (v3):
  32.   -Adopted the 'Update ODF Projects' script so that it does NOT
  33.    call DoItPPC() and therefore avoiding a critical error that
  34.    a file could not be found!
  35.   -Adopted globals ODPath and LibraryPath.
  36.    Result: changed ODF samples!
  37.  
  38.  
  39. Build ODF libraries & examples
  40. ------------------------------
  41.  
  42. The ODF libraries *have* to be rebuild. The documents stated that it is not
  43. necessay.
  44. However, you'll run into compiler errors. The solution is a recompile of
  45. the precompiled headers, i.e. rebuild the ODF R1 libraries!
  46. This was mentioned in the ODF-Interest list and seems to be tied to ODF R1.
  47.  
  48. Removed as much extensions and control panels as necessary (dependent on your
  49. available RAM). I kept RAM Doubler in, else processes like ODFFoundation
  50. building generated 'out-of-memory' errors. I experienced no problems with
  51. RAM Doubler 1.6.2.
  52.  
  53. Extension Manager list:
  54. Extension:
  55. CFM-68K Runtime Enabler,  RAM Doubler, AppleScript, Finder Scripting Extension.
  56. Control Panels:
  57. Date & Time, General Controls, Memory, Mouse
  58. For a more detailed listing: see my section 'System Configuration'.
  59.  
  60. Use 'ODF Builder' from CW9 Conversion v3. It asked for 'CodeWarrior IDE 1.4'
  61. (just select your latest CW IDE compiler), and for the ODF folder, which is
  62. located inside the ODFDev folder.
  63.  
  64. Set option for Architecture PowerPC off and for 68K on. Set/reset examples
  65. and Debug or Release options as you wish (I had the example and Debug
  66. options set).
  67.  
  68. The total time to build all ODF layers and samples: approx.4-5 hours om my
  69. 33Mhz IIVx. Just let it run and enjoy other things...
  70.  
  71.  
  72. Build myPart with PartMaker 4.4.1
  73. ---------------------------------
  74.  
  75. Parts has to be made with PartMaker 4.4.1 (or higher).
  76.  
  77. Double-click on a PartMaker sample (on the OpenDoc DR5). It opens
  78. Partmaker, asks for 'Name Part' and 'Company Name', and for location where
  79. it will place the files.
  80. Recommendation: select existing ODFDev, so it will create a subfolder into it.
  81.  
  82. Test:
  83. 1. generated myHello from Hello.
  84. 2. removed all subfolders, except CW68KDebug, CW68KRelease, and Sources.
  85. 2. adopted the RunTime segments according to CW9 Conversion v3.
  86. 3. adopted minimal the 'nmap' resources and signature (see PartMaker Read Me).
  87.    So the basic checklist of resources to modify is as follows:
  88.    - 'nmap' resources
  89.    - Mac OS creator type for the part
  90.    - Mac OS icons for the part (optional)
  91. 4. Project-Make to build myPart.
  92.  
  93. Note: building myPart can be done in 'nominal' memory situations, i.e.
  94. not with a subset of extensions and control panels! The time to build myPart
  95. is reasonable (minutes...).
  96.  
  97.  
  98. Run myPart
  99. ----------
  100.  
  101. Put an alias of ODFLibrary in the Editors folder. I have an Editors folder
  102. in the top folder of the same volume where I have installed CodeWarrior.
  103. You can also use the one in the System Folder.
  104.  
  105. Put an alias of myPart in the Editors folder.
  106.  
  107. Drop myPart on the OpenDoc Launcher (original in System Folder:Extensions)
  108.    -> a stationary of myPart is generated in Stationary Folder
  109.  
  110. Open Stationary Folder and create documents of myPart by double-clicking on
  111. myPart stationary.
  112.  
  113. Note: only one ODFLibrary, or an alias, must be present in the Editors Folder.
  114.  
  115.  
  116. Where to go from here
  117. ---------------------
  118.  
  119. Well, the CodeWarrior and ODF development tools are ready for your
  120. imagination to create and build your own part.  Have fun, and see you on
  121. the Net especially in the ODF-Interest mailing list.
  122.  
  123.  
  124.  
  125. System configuration
  126. --------------------
  127.  
  128. * CodeWarrior 9: 'Heaven' C++ installation, then upgraded to IDE 1.6.3, and
  129. Debug 1.5.1.
  130.  
  131. * System 7.5.3. No Revision 2 update.
  132.  
  133. * Extensions (while building ODF libraries):
  134. OpenDoc Libraries,  RAM Doubler, Scripting Additions,  CFM-68K Runtime
  135. Enabler, NuDragLib.slb, NuTranslationLib.slb, SOMobjects™ for Mac OS.
  136.  
  137. * Control Panels (while building ODF libraries):
  138. QuickTime™ Settings, Editor Setup, Sharing Setup, AppleTalk, TCP/IP, Mouse,
  139. General Controls, Monitors, Extensions Manager, Memory, Startup Disk,
  140. Sound, Keyboard, Map, Date & Time, File Sharing Monitor, Labels, Users &
  141. Groups, Views, Numbers, Text, Colour
  142.  
  143. * Mac IIVx (68030, 33MHz), HD: 1.2GB, effective free 300MB, RAM: 20MB, RAM
  144. Doubled to 40MB, effective free: 35MB (logical).
  145.  
  146.  
  147.  
  148. ________________
  149. Do you believe in Macintosh? Learn how to help the cause by subscribing
  150. to the "EvangeList" listserver! Send email to: <evangelist@macway.com> or
  151. check out <http://www.evangelist.macaddict.com/>.
  152.  
  153.  
  154.  
  155.